home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / MONITOR / VGAPAL.ARJ / VGAPAL.DOC < prev    next >
Text File  |  1992-01-10  |  10KB  |  254 lines
  1.        
  2.         ╔══════════════════════════════════════════╗
  3.         ║ VGAPAL  Copyright (c) 1992 Malcolm Drury ║
  4.         ╚══════════════════════════════════════════╝
  5.  
  6.      Note: this package contains the following files:
  7.  
  8.                      VGAPAL.EXE
  9.                      SETPAL.COM
  10.                      MODE3.COM
  11.                      VGAPAL.DOC
  12.                      STARTUP.VGA
  13.  
  14. VGAPAL.EXE is a utility that allows you to customize the colors
  15. your VGA card uses for text, by individually adjusting their red,
  16. green and blue components (in stages from 0 to 63).  The standard
  17. set of VGA colors is equivalent to those used by the EGA card;
  18. VGAPAL allows you to create a TSR (Terminate and Stay Resident)
  19. program called RAINBOW.COM that automatically maintains a text mode
  20. color scheme YOU define.  It also allows you to switch off the
  21. "blink" text mode and thereby give you access to 256 color
  22. combinations (i.e. 16 foreground by 16 background).  The
  23. accompanying program SETPAL allows you to display these
  24. combinations.
  25.  
  26.  
  27. RAINBOW requires only 2k of RAM; if you use DOS 5.0 or a memory
  28. mapping utility such as QEMM, you should be able to load it into
  29. high memory without difficulty.
  30.  
  31.  
  32. *** IMPORTANT ***
  33.  
  34. The author makes no warranty that VGAPAL and RAINBOW will work with
  35. your particular hardware configuration.  Further, you use the
  36. programs entirely at your own risk, and the author will not be held
  37. liable for any damage caused to your hardware or software through
  38. use of VGAPAL.EXE or RAINBOW.COM.
  39.  
  40.  
  41. Legalities aside, you should not run into difficulties with this
  42. software.
  43.  
  44. VGAPAL and the other programs in this package are distributed as
  45. "contributory shareware".  You do not have to register as a user,
  46. nor are you under any obligation to pay for the use of the
  47. programs.  However, in the spirit of shareware, you are requested
  48. to consider making a small donation to the author if you find the
  49. software in this package useful.  The suggested contribution is
  50. $10, but less (or more!) would be fine.  Should you decide to make
  51. a contribution, please remit to:
  52.  
  53.                    Malcolm Drury
  54.                    11 Adele Crescent
  55.                    Nepean
  56.                    ON  K2J 2T7
  57.                    Canada
  58.  
  59. Thank you.
  60.  
  61. Please note that your contribution will not entitle you to
  62. technical support, nor to receiving any upgrades, should they
  63. become available. The program is supplied on an "as is" basis, and
  64. is fully functional - not crippled in any way.  Furthermore, you
  65. will never be prompted with "Have you paid me yet?" notices.
  66.  
  67. You are free to distribute this software package provided that you
  68. distribute the ENTIRE package, including this documentation file.
  69.  
  70. Now to the fun stuff!
  71.  
  72.  
  73.         **************************************************
  74.  
  75. VGAPAL
  76.  
  77.  
  78. VGAPAL allows you to change all of the 16 colors available to DOS
  79. programs, and to establish color schemes for up to four different
  80. palettes.  You can save your palette settings to an ASCII file for
  81. later retrieval, and you can also save the color scheme for palette
  82. 1 (the DOS default) to create a small TSR, RAINBOW.COM, that, when
  83. loaded, will maintain your text color schemes under most
  84. circumstances.  It will NOT maintain your chosen scheme with ill-
  85. behaved software that resets the DOS default color scheme. (If you
  86. run such software, type  mode3  after exiting; this will cause a
  87. mode change that will trigger rainbow.com). RAINBOW knows when it
  88. is loaded, so you can't inadvertently load it more than once, thus
  89. using up precious memory.
  90.  
  91. Usage:  vgapal [filename] [/s]
  92.  
  93. 1. Editing color palettes
  94.  
  95. Editing is simple.
  96.  
  97. The up and down arrow keys select the color to be edited.
  98.  
  99. The  r, g and b keys select which component (red, green or blue) of
  100. the selected color to change.
  101.  
  102. The left and right arrow keys decrease or increase the selected
  103. component (between 0 and 63).
  104.  
  105. The Ctrl-left arrow and Ctrl-right arrow keys  darken or lighten
  106. the selected color by decrementing or incrementing the value of
  107. each component (red, green ,blue).  This process stops when one or
  108. more component reaches zero in decrement mode or 63 in increment
  109. mode).
  110.  
  111. Each time you press a left or right arrow, or Ctrl-left arrow or
  112. Ctrl-right arrow, the new color appears on the display, and the
  113. numeric values of the components are indicated to
  114. the right of the component selection scale.  Just try it!
  115.  
  116. At any time you can also cause the colors to grade uniformly from
  117. color 1 to color 15; just press s.  To undo this effect, press u.
  118.  
  119.  
  120. 2. Saving your chosen scheme
  121.  
  122. You can exit the program any time without permanently saving your
  123. changes by pressing  End.
  124.  
  125. You can exit the program and save your changes by pressing Esc.  If
  126. you do this, you will first be asked if you want to write a new
  127. palette file for later use.  Press y or n as required.
  128.  
  129. Next, you will be asked if you want to save one of the current
  130. palette settings and create RAINBOW.COM.  If you select yes (by
  131. pressing y), you will then be given two further choices.  You can
  132. select the cursor shape - either block (press b) or normal
  133. DOS-default underline (u). Personally, I prefer the block.
  134.  
  135. You will also be asked if you want RAINBOW.COM to maintain your
  136. palette for normal VGA text mode (mode 3, 80 column by 25 lines)
  137. only, or for all enhanced modes (e.g. 132 column x 43 lines).  If
  138. you choose the latter, you may find that colors in some graphics
  139. modes are also affected.  I suggest you choose this setting only to
  140. fine tune the brightness of the default EGA colors (which, on some
  141. hardware configurations, are rather drab).  If you run into
  142. unacceptable problems, rerun VGAPAL and choose normal text mode
  143. only (press t).
  144.  
  145. POWER USERS:  if you select all enhanced modes, RAINBOW.COM maintains
  146.               your chosen color scheme for all modes below (and
  147.               including) mode 85 (hex 55).  You can change this through
  148.               DEBUG by typing:
  149.  
  150.                 debug rainbow.com  {Enter}
  151.                 e 179 xx  {Enter}
  152.                 w {Enter}
  153.                 q {Enter}
  154.  
  155.               where xx is the mode number, IN HEXADECIMAL NOTATION, above
  156.               which you wish RAINBOW.COM to be inactive.  You will need
  157.               to determine this mode from your SVGA adapter manual.        
  158.  
  159. Finally, you will be asked if you wish to disable the "blinking"
  160. text.  If you choose yes (by pressing y), you will have access to
  161. 256 color combinations (16 foreground, 16 background).  Chooses no
  162. (by pressing n) if you want to see blinking text.  NOTE: IF YOU
  163. HAVE SELECTED "all enhanced VGA modes" IN THE SELECTION ABOVE,
  164. CHOOSE "y" TO DISABLE BLINKING, OTHERWISE SOME OF YOUR GRAPHICS
  165. MODES WILL ALSO SHOW THE BLINKING EFFECT.
  166.  
  167. 3. Using a pre-defined palette
  168.  
  169. On the VGAPAL command line, "filename" is the name of a palette
  170. file containing color settings that you have chosen using VGAPAL
  171. previously.  A palette file called STARTUP.VGA is provided with
  172. this package.  
  173.  
  174.  
  175. Additional color palettes
  176.  
  177. In addition to the default 16 color palette, you can use VGAPAL to
  178. set three other VGA palettes.  Cycle through the available palettes
  179. by pressing p.  If your screen goes blank when you do this, it
  180. means that the colors for the selected palette have not yet been
  181. set (or that your system has blown a fuse!).  Just press the left
  182. arrow; this will establish a color for the background, and allow
  183. you to read the screen.  You can then edit the colors as usual.  
  184.  
  185.  
  186. 5. SETPAL.COM
  187.  
  188. Usage: setpal n [/b]
  189.                
  190.               n is the color palette you want (1-4, or 5 for grey 
  191.               scale)
  192.  
  193.               /b (optional) enables blinking text; the default is 
  194.               blinking text set off.                 
  195.  
  196. This program allows you to switch among the four color palettes,
  197. or, alternatively, to establsih a grey scale palette. Note that
  198. some DOS software will switch to default palette 1. Sorry, RAINBOW
  199. won't handle that.  Don't you just hate software that won't allow
  200. you to configure your color scheme the way YOU want it?
  201.  
  202. This program will help power users who want to change color schemes
  203. through DEBUG or another byte editor.  (For example, many of PC
  204. Magazine's utilities can be customized).  SETPAL shows the full
  205. range of colors available in the current palette, along with their
  206. hex number identifiers.
  207.  
  208.  
  209.  
  210. USING RAINBOW.COM
  211.  
  212. When you have created a palette scheme you like for palette 1, exit
  213. VGAPAL by pressing Esc and answer y at the prompt "create
  214. RAINBOW.COM?".  Copy RAINBOW.COM into your root directory, or any
  215. directory referenced by your PATH statement, then place the
  216. following statements, in sequence, in your AUTOEXEC.BAT file, then
  217. re-boot (press Ctrl-Alt-Del):
  218.  
  219. rainbow
  220. mode3
  221.  
  222.  
  223. MODE3.COM is a small program that resets your system to text mode
  224. 3; it is necessary to initialize RAINBOW.COM.
  225.  
  226.  
  227. Unlike some TSR programs, RAINBOW.COM contains no "nasty surprises"
  228. such as undocumented or barely legal calls to the system.  If you
  229. should experience problems in which RAINBOW seems to conflict with
  230. other TSR programs, try removing them one by one; if removing one
  231. remedies the situation, that is probably the one causing rhe
  232. problems.  You could then try rearranging the order in which you
  233. load your TSRs.  If your problem persists, and you can't live
  234. without the TSRs you were using before you tried RAINBOW, all I can
  235. say is sorry, but it's tough out there in TSR-land. 
  236.  
  237. SETTING PALETTES WITHOUT RAINBOW
  238.  
  239. If memory is a problem, you can set your color scheme, as saved in
  240. an ASCII file format, by running VGAPAL as follows:
  241.  
  242. VGAPAL filename /s
  243.  
  244. The /s switch causes VGAPAL to load the palette file and then exit
  245. without showing the edit screen.  Please note, however, that your
  246. color scheme will NOT be maintained following a mode change (e.g.
  247. switching back to text mode from graphics mode).  You would have to
  248. run VGAPAL as shown again to re-establish your color scheme. As
  249. RAINBOW only uses about 2k of RAM, and is a simple TSR that has no
  250. "hot key" functions or screen display functions that eat memory,
  251. its memory requirement should not be a problem.  
  252.  
  253.  
  254. I hope you find this package useful.